调试日志文件

附录 G

---

调试日志文件和报告日志文件都是许可服务器系统生成的。本附录重点介绍调试日志文件。关于报告日志文件的信息，请参见附录 F“报告日志文件”。

调试日志文件包含对调试许可服务器系统有帮助的状态信息和错误信息。许可服务器系统总是不断生成调试日志输出。有些调试日志输出说明了 lmgrd 特有的事件，有些则说明了每个供应商守护程序特有的事件。

管理调试日志输出

lmgrd 及其供应商守护程序运行一段时间后，调试输出文件会增大。而随着时间的推移，旧的调试日志输出的价值会降低。因此，有必要将旧的调试日志输出与新的输出分开，然后将其归档或删除。

为了获得更好的性能，建议将调试日志文件保存在运行 lmgrd 及其供应商守护程序的计算机的本地磁盘上。但是，如果调试日志文件必须保存在远程装入的磁盘上，而且发现许可服务器系统运行速度很慢，请使用 -nfs_log 选项启动 lmgrd，即可改善性能。

关于调试日志输出格式的介绍，请参见“调试日志信息”。

捕获许可服务器系统的调试日志输出

默认情况下，lmgrd 及其管理的供应商守护程序将调试日志输出写入标准输出。要将调试日志输出放在文件中，可以将许可服务器的输出重新定向到文件，或者使用 -l debug_log_path 选项启动 lmgrd。

捕获特定供应商守护程序的调试日志输出

不同供应商守护程序（由同一许可服务器系统控制）的调试日志输出可以被写入到各自的文件中（供应商守护程序 v8.0+）。实现该操作的方法有两种：

在每个供应商守护程序的选项文件中添加 DEBUGLOG 行。详细信息请参见“DEBUGLOG”。
在供应商守护程序中调用 lmswitch。详细信息请参见“lmswitch”。

请注意，lmgrd 将自己的调试日志输出写入标准输出。

重新定向运行的供应商守护程序的调试日志输出

可以将特定的供应商守护程序的调试日志输出重新定向到不同的文件。实现该操作的方法有两种：

更改供应商守护程序的选项文件中的 DEBUGLOG 行，并通过调用 lmreread 重新读取选项文件。详细信息请参见“DEBUGLOG”。
对供应商守护程序调用 lmswitch。详细信息请参见“lmswitch”。

限制供应商守护程序的调试日志输出

默认情况下，调试日志输出包含所有事件。要限制为特定供应商守护程序记录的事件，请在该供应商守护程序的选项文件中添加 NOLOG 行。详细信息请参见“NOLOG”。限制记录的事件的原因之一是可以减小调试日志输出的大小。

调试日志信息

FLEXnet Licensing 进程可生成以下格式的调试日志文件：

hh:mm:ss (daemon) message

其中：

hh:mm:ss	记录信息的时间。
daemon	lmgrd 或供应商守护程序的名称。在单个守护程序副本无法处理所有需要的许可证的情况下，在后面加上可选“_”以及数字，以便表示此信息来自一个子守护程序。
message	信息的正文。

调试日志文件可用于：

诊断配置问题
诊断守护程序软件错误

---

注意：调试日志文件不能由 FLEXnet Manager 用于报告使用情况。

---

说明性信息

信息	说明
Connected to host	此守护程序与 host 连接。
CONNECTED, master is host	当设置了定额且各方都已选择了主机时，许可证守护程序将记录此信息。
DENIED:num_lic feature to user	user 被拒绝访问 feature 的 num_lic 许可证。
EXITING DUE TO SIGNAL nnn EXITING with code nnn	所有守护程序列表都列出了退出该守护程序的原因。
EXPIRED:feature	feature 已超过其截止日期。
IN:"feature" user (num_lic licenses)	user 已经检入了 feature 的 num_lic 许可证。
Lost connection to host	守护程序无法再与节点 host 通信，这会使得客户端不得不重新连接或使守护程序的数量小于最小数量。在这种情况下，客户端可能会准备退出。如果许可证守护程序与主机断开连接，将终止所有的供应商守护程序；而供应商守护程序会自行关闭。
Lost quorum	守护程序丢失了定额，因而只能处理其他守护程序的连接请求。
MULTIPLE vendor servers running.Please kill, and restart license daemon.	许可服务器管理器 lmgrd 检测到 vendor 的多个供应商守护程序正在运行。使用 lmdown 实用程序关闭 lmgrd 和所有的 vendor 守护程序，然后重新启动 lmgrd。
OUT:"feature" user (num_lic licenses)	user 已经检出 feature 的 num_lic 许可证。
RESERVE feature for USER user RESERVE feature for HOST host	feature 的许可证是为 user 或 host 保留的。
REStarted vendor (internet port nnn)	供应商守护程序 vendor 在 TCP/IP 端口 nnn 重新启动。
Retrying socket bind (address in use)	许可服务器系统如果检测到“address in use”错误，则会尝试将其套接字绑定 6 分钟左右。
Selected (EXISTING) master host.	此许可证守护程序选择了一个现有的主要 host 作为主机。
SERVER shutdown requested.	通过用户发出的 kill 命令要求关闭守护程序。
Server started on host for:"feature_list"	一个（可能是新的）服务器被启动，以便获取所列出的功能。
Shutting down vendor	许可服务器管理器正在关闭供应商守护程序 vendor。
SIGCHLD received.Killing child servers.	当许可证守护程序请求关闭时，供应商守护程序会记录此信息。
Started vendor	每当许可服务器管理器启动新的供应商守护程序时便会记录此信息。
Trying to connect to host	守护程序正在尝试连接到 host。

配置问题信息

信息	说明
host:Not a valid server host, exiting	此守护程序在无效的主机名上运行。
host:Wrong hostid, exiting	host 的主机标识错误。
BAD CODE for feature	指定功能名的许可证号或签名错误。可能是输入错误，也可能是被最终用户进行了修改。
CANNOT OPEN options file file	无法打开许可证文件中指定的选项文件。
Couldn't find a master	守护程序与主机不匹配。
License daemon:lost all connections	此信息在丢失与服务器的所有连接时被记录，通常表示出现网络故障。
Lost lock, exiting Error closing lock file Unable to re-open lock file	供应商守护程序的锁定文件发生问题，这通常是由于尝试在单个节点上运行多个守护程序副本而造成的。找到通过 ps 命令运行的其他守护程序，并用 kill -9 将其终止。
No DAEMON line for vendor	许可证文件不包含 vendor 的 DAEMON 或 VENDOR 行。
No DAEMON lines, exiting	如果许可证文件中没有 DAEMON 或 VENDOR 行，许可证守护程序将记录此信息。因为没有要启动的供应商守护程序，所以许可守护程序也没有要执行的任务。
No features to serve!	供应商守护程序未发现可以提供的功能。这可能是由损坏的或错误输入的许可证文件造成的。
UNSUPPORTED FEATURE request:feature by user	用户请求了此供应商守护程序不支持的功能。这可能由很多原因造成：许可证文件错误、功能已过期或者守护程序访问了错误的许可证文件。
Unknown host:host	网络数据库（可能是 /etc/hosts）中不存在许可证文件中的 SERVER 行上指定的主机名。

守护程序软件错误信息

信息	说明
accept:message	在“accept”系统调用中检测到错误。
Can't allocate server table space	内存分配错误。检查交换空间。
Connection to host TIMED OUT	守护程序不能连接到 host。
Illegal connection request to vendor	向 vendor 发出连接请求，但是此供应商守护程序不是 vendor。
read:error message	在“read”系统调用中检测到错误。
select:message	在“select”系统调用中检测到错误。这通常表示发生了系统网络故障。
Server exiting	正在退出服务器。这一般是由于错误所致。